package com.ip.user.mapper;

import com.ip.user.models.bo.UserBO;
import com.ip.user.models.vo.UserVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户Mapper接口
 */
@Mapper
public interface UserMapper {
    
    /**
     * 插入用户
     * @param userBO 用户BO对象
     * @return 影响行数
     */
    int insertUser(UserBO userBO);
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户VO对象
     */
    UserVO selectUserById(Long id);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户VO对象
     */
    UserVO selectUserByUsername(String username);
    
    /**
     * 查询所有用户
     * @return 用户VO列表
     */
    List<UserVO> selectAllUsers();
    
    /**
     * 分页查询用户
     * @param offset 偏移量
     * @param pageSize 每页大小
     * @param username 用户名（可选）
     * @param status 状态（可选）
     * @return 用户VO列表
     */
    List<UserVO> selectUsersByPage(@Param("offset") int offset, @Param("pageSize") int pageSize, 
                                   @Param("username") String username, @Param("status") Integer status);
    
    /**
     * 查询用户总数
     * @param username 用户名（可选）
     * @param status 状态（可选）
     * @return 用户总数
     */
    int selectUserCount(@Param("username") String username, @Param("status") Integer status);
    
    /**
     * 更新用户信息
     * @param userBO 用户BO对象
     * @return 影响行数
     */
    int updateUser(UserBO userBO);
    
    /**
     * 更新用户状态
     * @param userId 用户ID
     * @param status 用户状态
     * @return 影响行数
     */
    int updateUserStatus(@Param("userId") Long userId, @Param("status") Integer status);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 影响行数
     */
    int deleteUser(Long id);
}